home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / UTIL / TouchMe 1.1.1.sit / touchMe 1.11 Folder / touchMe 1.11 readme < prev    next >
Text File  |  1996-08-08  |  7KB  |  121 lines

  1.  
  2. touchMe 1.1.1 (August 8, 1996)
  3. Copyright ゥ1996 Mizutori Tetsuya
  4. This program is a freeware.
  5.  
  6. About touchMe program
  7. This is an application program to change the creation and/or modification date time of any Macintosh files or folders. It is like Unix command メtouchモ. To run the program, it requires System 7.1 or later. Under System 7.5, touchMe is also AppleScriptable and allows to accept drag & drop operations. The program is written under the Metrowerksユ C++ application framework of PowerPlant.
  8.  
  9. Why is needed touchMe?
  10. I have been using this program for these two years in private to set the right date time stamps of archive files that I downloaded. The reason I want to change the date time stamps is that the archive files can have the correct date time corresponding to their original files. There may be a way to do this with ResEdit, but using touchMe is more practical.
  11.    CASE 1 such that you have the archive file and the original file in the same folder. To set the date time stamp of archive file to the one of original, select both files, but the original file must be the first, and drag & drop them onto the touchMe application icon.
  12.    CASE 2 such that these files are located in different folders or volumes. A nice tip to set the date time stamps. On running the touchMe application, select and drag & drop the original file into the window area of touchMe application to fetch its date time stamp. And then select the archive file and drag & drop it onto the touchMe application icon.
  13.  
  14. How to use it?
  15. First of all, you should setup the optional switches of touchMe program, which are listed below;
  16.  [x] to Update creation / modification date...
  17.   ・ to the current date time
  18.   ・ to [exact date time]
  19.   ・ to fetch the first item
  20.   ・ to fetch the first item, and set
  21. These settings are automatically stored to touchMe preferences file when you quit by メOKモ button.
  22.      Second, select and drag & drop the files or folders onto the touchMe application icon. Or, with the option-key pressed, you can drag & drop them in the touchMe window area, instead. During a drag & drop with option-key pressed, the command メtouchモ and メfetchモ are exchanged temporarily each other. Then all the files you selected are changed to have the same creation and/or modification date time. You can confirm it in Finderユs メGet Infoモ dialog.
  23.  
  24. How work the switches?
  25.   ・ to the current date time
  26.      All the files or folders you selected are to have the same current date time.
  27.   ・ to [exact date time]
  28.      Enter the date time, like as メ8/1/96モ for date and メ12:34:56モ for time. There are four ways to set these date time fields as follows.
  29.      1) Type in the date time strings. Please be careful to enter them in the right date time format.
  30.      2) Push a tiny button at top-right corner to get the present time.
  31.      3) Press the option-key when you open or drag & drop the file (or folder). The date time stamp is fetched from the target file (or folder) and is set to the fields properly.
  32.      4) Under System 7.5, drag & drop the file (or folder) directly in the touchMe window. When the dragged item has entered the window area, all the fields are turned hilited to indicate to accept its date time stamp. In particular, each field is also sensitive to accept and fetch the date or time stamp separately from the dropped item.
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.   ・ to fetch the first item
  42.      touchMe can fetch the date time stamp of the メfirstモ item among the files (or folders) you selected. Well, what does it mean the メfirstモ? It may differ under the various conditions by which view you open the Finderユs folder.
  43.      1) View by Small Icon or Icon; The first item is the one you selected the first. You may choose additional files or folders as the followers by clicking them with shift-key pressed.
  44.      2) View by Name, Size, Kind or Date; The first item is the one which is listed at the topmost column in the list window. The order may not be changed even if you choose the items separately by shift-clicking.
  45.   ・ to fetch the first item, and set
  46.      It works the same to above switch, and additionally to set the date time stamp of the first item to the fields. 
  47.  
  48. AppleScript commands
  49. Required Suite:
  50.     open  alias   -- touch the items
  51.     print  alias  -- (do nothing)
  52.     run     -- Sent to an application when it is double-clicked
  53.     quit    -- Quit application
  54.  
  55. touchMe Suite:
  56.  get prefs creation/modification -- get the current settings
  57.    Result:   prefs  -- list of current settings
  58.  set prefs creation/modification to prefs -- set the new settings
  59.  load prefs  -- load the settings from the preferences file
  60.  save prefs  -- save the settings to the preferences file
  61.  touch  alias  -- touch the items
  62.  fetch  alias  -- fetch the item, and set the date time settings
  63.    Result:  time stamp -- list of creation and modification date time
  64.  
  65. Class prefs: Settings information
  66. Properties:
  67.  enabled  true/false
  68.  flag  current/exact/firstone/firstset
  69.  value  date value
  70.  
  71. Class time stamp: creation and modification date time
  72. Properties:
  73.  creation date  date value
  74.  modification date  date value
  75.  
  76. Example: A droplet to change the creation date to the current date, and the modification date according to the first file
  77. on open (docList)
  78.   tell application "touchMe"
  79.     set theDate to current date
  80.     set xDate to date "8/1/96 12:34:56"
  81.     set prefs creation to {enabled:true, flag:exact, value:theDate}
  82.     set prefs modification to {enabled:true, flag:firstone}
  83.     touch docList
  84.     quit
  85.   end tell
  86. end open
  87.  
  88. Revision history
  89. ・ v.1.1.1, published on August 8, 1996
  90.  - New. During a drag & drop operation with option-key pressed, the command メtouchモ and メfetchモ are exchanged temporarily each other.
  91.  - New. Four date time fields are sensitive to accept items separately.
  92.  - New. It remembers the last window position on quit by メCancelモ.
  93.  - Bug. A well-known (but, I didnユt know:-) MacOS bug on using colored alert boxes is fixed. Thanks to Rokkaku Fumio who presented me with a nice solution.
  94.  - New. Enabled the メClose Boxモ in the window title that works as メCancelモ button, and the help menu item of the desktop menu bar.
  95.  - New. Added some practical AppleScript samples.
  96.  - Bug. Corrected a typo, a wrong file name for メtouchMe Prefsモ.;-)
  97.  - Special thanks to Jim van Zee who has always encouraged me in this project and made some cool suggestions to cover the problems.
  98. ・ v.1.1, published on August 1, 1996
  99.    All the programs were rewritten for the Metrowerksユ C++ application framework PowerPlant of CodeWarrior.
  100. ・ v.1.0, first released on March 9, 1994
  101.    The first version of the program, originally written in Symantecユs THINK-C.
  102.  
  103. The package includes...
  104.    1. touchMe              -- a fat-binary application program
  105.    2. touchMe readme  -- just this file you are reading
  106.    3. touchMe scripts  -- sample AppleScript code using with touchMe
  107.    4. touchMe source   -- source code in CodeWarrior DR9 PowerPlant
  108. This is a freeware program. You can distribute it without any limitations nor permissions.
  109.  
  110. Bug reports
  111. If you have any questions, suggestions or problems, please feel free to contact me via e-mail;
  112.    <mailto:mizutori@ai.rcast.u-tokyo.ac.jp>
  113.    <mailto:mizutori@po.iijnet.or.jp>
  114. The latest versions of my software are available at my following WWW page;
  115.    <http://www.bekkoame.or.jp/~mizutori/software/catalog.html>
  116.  
  117. --
  118. Mizutori Tetsuya, RCAST, Univ. of Tokyo, Japan
  119. mizutori@ai.rcast.u-tokyo.ac.jp
  120.